Apple II
Sample Code Notes
_____________________________________________________________________________
                                                  Developer Technical Support

#16:    Aware

Version:    3.0                                                     June 1990

APW Components:    MPW Components:

Aware.c            Aware.c
Aware.h            Aware.h
Aware.rez          Aware.r
Config.c           Config.c
Event.c            Event.c
Menus.c            Menus.c
Globals.c          Globals.c
Aware.Link         MakeFile
Build
Build.r
Full.Build

Aware is intended to show how easy it is to make an application reasonably 
AppleShare-aware without having to use network-specific routines or calls.
It shows off the @ prefix of AppleIIGS System Software 5.0 and the GS/OS
class 1 Open call.
_____________________________________________________________________________

Aware is a very simple program that shows how to use the @ prefix and GS/OS 
class 1 Open call to be network aware.  When Aware starts up, it gets the
date and time it was last run from a configuration file, and when it quits,
it updates the date and time fields in the configuration file.  There are
menu items to allow you to force the configuration file to be loaded and
saved.  The last run date and time are displayed as part of Aware's About
dialog box.

The @ prefix is the name of the directory where configuration information can 
be stored.  Its actual contents depend upon from where the application was 
launched.  If the application is launched from a non-AppleShare disk, the @ 
prefix is set to the directory containing the application (the same as prefix 
1).  If the application is launched from an AppleShare disk, the @ prefix is 
set to that user's folder on the user volume of the file server (if there is 
no user volume online, the @ prefix reverts to the directory containing the 
application).  This method is useful for saving configuration information, 
defaults, or preferences on a per-user name basis.  Note that if several 
people are logged on to the same server with the same user name, and launch 
the application from a server, they all access the same configuration file 
(even though you use the @ prefix).  It is up to the users to log on with 
different names if they want to personalize their configuration, defaults, or 
preferences.

APW users need APW v.1.0, APW C v.1.0, APW Tools & Interfaces v.1.1, and
Apple IIGS System Software 5.0.2 or later.  Three APW command files,
Full.Build, Build, and Build.R allow you to perform complete or partial
rebuilds of the load file Aware.  MPW IIGS users need MPW v.3.0, MPW IIGS
Tools v.1.1, and MPW IIGS C v.1.0 or later.  The name needed by the MPW
Build menu's Build option can be found in the MakeFile.
